Inside Macintosh: QuickDraw GX Printing /

Chapter 2 - Core Printing Features / Core Printing Features Reference

Functions / Displaying the Page Setup and Print Dialog Boxes

GXInstallApplicationOverride

You can use the GXInstallApplicationOverride function to override messages QuickDraw GX sends to your application.

void GXInstallApplicationOverride (gxJob aJob, short messageID,
                                    void *override);

aJob

A reference to the job object into which to install the override.

messageID

The ID of the message to override.

override

A pointer to a function with which to override a message.

DESCRIPTION

You can use the GXInstallApplicationOverride function to specify a function that is called in response to the message specified in the messageID parameter. For example, you can override the gxPrintingEvent message that QuickDraw GX sends to your application each time it receives an event by specifying a function to call in the override parameter.

You specify a pointer to an override function in the override parameter. Set this parameter to nil to remove your application's override of a message.

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

Listing 2-1 on page 2-12 shows how to override the gxPrintingEvent message using the GXInstallApplicationOverride function.

Supporting QuickDraw GX dialog boxes is discussed in "Supporting QuickDraw GX Print Dialog Boxes," which begins on page 2-17.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help